home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Workbench Design
/
WB Collection.iso
/
workbench werkzeuge
/
wbstartup
/
wbstartup+v2.5
/
wbstartup+.guide
(
.txt
)
< prev
next >
Wrap
Amigaguide Document
|
1996-04-07
|
24KB
|
594 lines
@database WBStartup+.guide
@master WBStartup+.guide
@$VER: WBStartup+.guide 2.5 (23.10.95)
@author "John Hughes"
@(c) "1995"
@index Index
@node "Main" "WBStartup+"
@{b}WBStartup+@{ub}
October 23, 1995
by: John Hughes
johughes@heartland.bradley.edu
WBStartup+
1995 John Hughes. All Rights Reserved.@{ub}
@{"
Installing/Updating
" link "INSTALL" 0} How to install or update WBStartup+.
@{"
Author
" link "AUTHOR" 0} About the author and compiler.
@{"
PostcardWare
" link "CONTRIBUTIONS" 0} This is Postcardware.
@{"
Features
" link "SYNOPSIS" 0} What WBStartup+ does.
@{"
L:WBStart-Handler
" link "WBSTARTHANDLER" 0} L:WBStart-Handler info
@{"
" link "BUGS" 0} Bugs in WBStartup+.
@{"
Where
Updates
" link "AVAILABILITY" 0} Places to get newer versions
@{"
Catalogs
" link "CATALOGS" 0} Information on included catalogs
@{"
History
" link "HISTORY" 0} Previous versions.
@{b}How to use:@{ub}
@{"
WBStartup+
" link "WBSTARTUP" 0}
@{"
WBStartup+Prefs
" link "WBSTARTUPPREFS" 0}
@{"
Changing
execution
order
" link "EXECUTEORDER" 0}
@endnode
@node "INSTALL" "Installation Instructions"
@{b}INSTALLATION:@{ub}
@{fg shine}Double click the "Install" icon to install WBStartup+ for the first time
or to upgrade from a previous version.@{fg text}
The installation script makes 2 directories,
"WBStartup (Enabled)" and "WBStartup (Disabled)".
"WBStartup (Enabled)" holds all the programs that
you want to run at startup, and the other holds
all your disabled startup programs (ie, ones
that you don't want to run at startup).
Everything in your SYS:WBStartup directory is
moved to the "WBStartup (Enabled)" directory.
The WBStartup+ program is copied to your
SYS:WBStartup directory.
The WBStartup+Prefs program is copied to your
SYS:Prefs directory.
@endnode
@node "AUTHOR" "Author & Tech"
@{b}About the author
and other tid-bits.@{ub}
Program: WBStartup+
Version: 2.5
Date: October 23, 1995
Coded by: John Hughes
Email: johughes@heartland.bradley.edu
WWW: http://rhf.bradley.edu/~jhughes/
Compiled with: SAS/C 6.56
Machine: A4000 68EC030/25 AmigaDOS 3.1
Required: AmigaDOS 2.0 or above
The preferences program requires AmigaDos 3.0 or above.
@{"
postcard
" link "CONTRIBUTIONS" 0}
Distribution: WBStartup+ is Postcardware.
As long as all of the archive stays intact and
unmodified, WBStartup+ may be distributed
anywhere.
I have released: PointerEyes 4.2 - Very configurable eyes that watch your
mouse pointer. Any size, and # of colors.
aminet:util/wb/PointerEyes4.2.lha
WBMakeLink - Menu in WB tools menu which makes links
to files and drawers, and makes an icon
for them.
aminet:util/wb/WBMakeLink.lha
Unreleased: A raytracer for Amiga Dos 3.x, but is designed to be portable.
@endnode
@node "CONTRIBUTIONS" "Contributions"
@{b}Postcardware@{ub}
WBStartup+ is @{i}Post Cardware@{ui}.
If you use WBStartup+, please send me a post card of your
country or city.
Of course I will take any type of donations. :)
@{i}Send to:@{ui}
John Hughes
901 Highview Rd.
East Peoria, IL 61611 USA
@{i}And even if you don't use WBStartup+, or don't like it, please
send me EMail telling me why. Thanks. :)@{ui}
I receive a very large amount of email from all over the world from
WBStartup+ users who have requests, bug reports, etc. But I have
received very few postcards compared to email. If you use WBStartup+,
please send me a postcard... It is a very cheap way to show your
appreciation for the product.
Special thanks go out to all the Europeans who have send me postcards.
This is because out of all the postcards I have received, I have only
one from the USA, which is rediculous considering I live in Illinois, USA!
@endnode
@node "SYNOPSIS" "Synopsis"
@{b}WBStartup+ does the following:@{ub}
o Easy to use GUI preferences program for OS3.x.
o Lets you choose the order in which the startup programs run.
o Lets you enable and disable the running of each program quickly.
o Allows you to have access to Workbench while all of your
startup programs are being loaded.
o Can be disabled at startup by holding left shift key down.
o Progress window shows the icon of the program that is being loaded,
and a progress bar with userdefine window background.
@endnode
@node "WBSTARTHANDLER" "WBStart-Handler Info"
@{b}WBStartup-Handler@{ub}
The WBStart-Handler is a handler written by Stefan Becker.
The full archive can be found on Aminet:util/cli/WBStart1_4.lha
@endnode
@node "BUGS" "Bugs"
@{b}Bugs@{ub}
Thanks go out to all those who reported bugs to me.
There seems to be a problem when you try to delete a group, but no group
has been made. My machine does it fine, but ohter people have said they get
an alert, please tell me ifyou have any problems with this.
I have no MMU, so it is very difficult to locate enforcer hits once they
are present.
Please keep me informed of any bugs that you find.
E-Mail: johughes@heartland.bradley.edu
@endnode
@node "AVAILABILITY" "Where to get Updates"
@{b}Locations to find Updates@{ub}
All WBStartup updates are first posted to Aminet at:
ftp://ftp.wustl.edu/~aminet/util/boot/WBStartupPlus.lha
Versions 1.0 to 2.0 were put in /util/wb, sorry for the change.
Updates are also available at my web site:
http://rhf.bradley.edu/~jhughes/
@endnode
@node "HISTORY" "History"
@{b}History@{ub}
V1.0 June 26, 1995
First release.
Thanks go to David Swasbrook for showing me an example of how to use GTLV_CallBack.
V1.1 July 16, 1995
Corrected a "July" to "June" in the docs.
I accidentally asked for money in the "About" menu in the prefs program,
all I want is a postcard.
Added MWB icons for the enabled and disabled directories.
Fixed the install script so that no files are deleted, making it much safer.
Minor changes in the documentation.
Added Title node to Prefs program's listview.
You can now change the loading priority of each startup program within
the prefs program.
Fixed menus so they are the right colors.
V1.2 July 17, 1995
Bug Fix: You could change the priority of title nodes.
You can now get the WB info requester for any of the programs in the
listview gadget of the Prefs program from a pulldown menu.
V1.3 July 18, 1995
Now runs programs without icons. Sorry about that :(
Bug Fix: Forgot to reply to a message in the Prefs program.
Forgot to free up some memory in the Prefs program.
V1.4 July 19, 1995
Prefs program now lists programs without icons, and no longer displays subdirectories.
V1.5 July 25, 1995
Bug Fix: Font was not being shown if it wasn't already loaded.
WBStartup+ Prefs now uses the screen font for it's text.
Added DELAY as a tooltype for WBStartup+.
WBStartup+ Prefs is completely font adaptive.
Bug Fix: It was possible to free gadgets more than once it all of them were not created.
V1.6 August 6, 1995
Selected entries in the listview are now shaded differently.
Added where to get l:wbstart-handler in the docs.
The list can be alphabetized from "Alphabetize list" in the "Edit" menu.
Added "ALPHABETIZE" as a tooltype. If the tooltypes exists, then the
list of programs will be alphabetized.
Now recognizes STARTPRI as the priority tooltype to conform more to OS3.x.
STARTUPPRI is still recognized, but obsolete, so if both STARTPRI and
STARTUPPRI are present, STARTUPPRI is ignored.
Changed the priority integer gadget to a slider gadget.
V1.7 August 15, 1995
WBStartup+Prefs window is now resizeable.
WBStartup+Prefs window now opens larger, depending on the visible screen size
and the number of lines in the listview gadget.
Can switch between Alphabetical sorting and Priority sorting via a menu.
If the list is sorted by priority, an edited priority will be moved into the
correct location in the list.
Fixed a couple font adaptive miscalculations.
V2.0 August 26, 1995
Programs can now be assigned to groups, making quick changes in the preferences
program quicker.
Holding the Left Shift key down during boot time, causes WBStartup+ to be disabled.
MAJOR BUG FIX: Programs without icons (projects) were not being recognized.
Added several Group management menu items.
Added Select All, None, Toggle menu items.
WBStartup+ will not run any program with the name of "WBStartup+", that way if
you have the WBStartup+ program in the enabled directory, it will not run
recursively forever.
The alphabetic ordering in WBStartup+Prefs is now case insensitive using Locale.
Prefs window opening width is smarter.
Changed the look of the WBStartup+Prefs icon to look like the standard MWB prefs icons.
V2.1 September 24, 1995
Now uses Memory Pooling instead of AllocVec().
Fixed potential bug in a list structure when alphabetizing.
Received permission to include L:WBStart-Handler in this archive.
Archive has moved to Aminet:util/boot
Removed accidental FreePool() when "Delete Group" was done, and there were no groups.
Enforcer Hit removed: forgot to initialize glist=NULL before CreateContext().
Did I release V2.0 WBStartup+Prefs with a missing tail parenthesis in two path tooltypes? Sorry.
A requester now appears when you quit without saving, and there was a group modification.
WBStartup+ now has an optional Progress Indicator when it runs, which can have a user defined background.
Changed the name of drawer icon images, so they don't have parenthises in them, that way
they can be archived with lzx. They are copyied by the installer script and given their
proper default names with parenthises.
Included a WBStartup+ version for OS2.x and OS3.x
Updated installer script to recognize OS2.x and OS3.x
V2.2 September 27, 1995
Removed bug causing possible crash when disabling the PROGRESSWINDOW tooltype.
V2.3 October 3, 1995
The WBStartup+Prefs window is now a WB AppWindow, so ou can drop icons into it
and a requester appears asking you if you want to copy or move the files to
the enabled or disabled directory.
Was allocating pathname size, and deallocating filename size.
Possible program crash removed due to another forgotten glist=NULL.
Add "..." to some menu items.
V2.4 October 4, 1995
Was allocating one byte less than needed for groupnames when creating them from the menu.
When resizing the window, the gadgets are remade, but glist was not initialized to NULL again.
WBStartup+ now sets the stack size for each loaded program, although WBStart-Handler seems
to not always use the exacts stack size specified.
Was allocating sizeof(struct Node) instead of sizeof(struct WBStartupNode) in the OS2.x version of WBStartup+.
V2.5 October 23, 1995
Now supports Localization. Included catalogs: Deutsch, Fran
ais, Italiano, Norsk, Svenska.
Holding the Ctrl key down when WBStartup+ is run will cause WBStartup+Prefs to be
run before any programs are loaded, allowing you to choose which programs get loaded.
Holding the left Alt key when WBStartup+ is run causes the user to be asked which of the
enabled programs should be run.
Added PREFSPATH tooltype to WBStartup+ icon. This is the location of the preferences file.
Program names are shown in WBStartup+'s progress window.
If the case of the letters in the filename and icon name varied, the same program name
would be recognized as two different programs. This is now fixed.
Added Cancel and Ok gadgets to the Copy File window.
The OS3.x version of WBStartup+ was getting it's bottom border of the prefs window
overwritten by the background pattern under the right icon image, if the user was
using sysihack.
WBStartup+ now recognizes the WAIT= tooltype as the # of seconds to wait before loading the next program.
WBStartup+ now recognizes the TOOLPRI= tooltype as the priority that the program should have when running.
The DELAY= tooltype is now obsolete, therefore it has been removed.
WBStartup+ now knows if it has already been run, and if it is run more than once, the user
will see a requester asking if it is ok to run it again.
The STARTUPPRI tooltype is no longer recognized, please use STARTPRI instead.
When the WBStartup+Prefs window is opened on a virtual screen, it is centered
vertically in the visible section, and is 100 pixels to the right of the leftmost
visible section.
The Amiga Workbench x.x text is now properly centered in WBStartup+'s progress window.
The busy pointer is now shown when a secondary window is opened, such as the Priority Window.
Sizing the main window is now impossible when a secondary window is opened since IDCMP is cut off.
Priority Window is now activated when opened.
You may use the keyboard up and down arrow keys to change the selected element in the listview gadget.
V2.6 October x, 1995
When no program is highlighted in WBStartup+Prefs, and the menu item "Icon Window" is selected,
a requester appears telling the user to select a program first.
@endnode
@node "WBSTARTUP" "How to use WBStartup+"
@{b}How to use WBStartup+@{ub}
@{b}@{u}Tooltypes@{ub}@{uu}
@{"
ENABLEDPATH
" link "ENABLEDPATH" 0}
@{"
DISABLEDPATH
" link "DISABLEDPATH" 0}
@{"
PROGRESSWINDOW
" link "PROGRESSWINDOW" 0}
@{"
BACKGROUNDPIC
" link "BACKGROUNDPIC" 0} (for OS3.x only)
@{"
PREFSPATH
" link "PREFSPATH" 0}
@{"
Startup
Programs
" link "STARTUPTOOLTYPES" 0}
@{b}@{u}HotKeys@{ub}@{uu}
@{b}Ctrl@{ub} Bringing up WBStartup+Prefs before running any programs.
@{b}Left-Alt@{ub} Asks user which of the enabled programs should be run.
@{b}Left-Shift@{ub} Disabling WBStartup+, no programs will be run.
@{"
Changing
execution
order
" link "EXECUTEORDER" 0}
@endnode
@node "WBSTARTUPPREFS" "How to use WBStartup+Prefs"
@{b}How to use WBStartup+Prefs@{ub}
The Prefs program allows you to choose which program to run at startup,
and in which order to run them.
@{b}@{u}Tooltypes@{ub}@{uu}
@{"
ENABLEDPATH
" link "ENABLEDPATH" 0} Must be the same as that of @{"
WBStartup+
" link "WBSTARTUP" 0}
@{"
DISABLEDPATH
" link "DISABLEDPATH" 0} Must be the same as that of @{"
WBStartup+
" link "WBSTARTUP" 0}
@{"
ALPHABETIZE
" link "ALPHABETIZE" 0}
@{b}@{u}App Window@{ub}@{uu}
You can easily copy or move files into the enabled or disabled directory
by simply dropping icons into the window from workbench.
A window will appear asking you if you want to copy or move the files, and
whether to put the files in the Enabled or Disabled directory.
@{b}@{u}The Listview Gadget@{ub}@{uu}
Each item in the list that has a checkmark will be run at startup.
To toggle the checkmark, just click the left mouse button on the checkbox.
To change the startup priority of a program, click in that area of the
listview, set the slider gadget to the desired priority and close the window.
To bring up the Workbench icon information window for one of the programs
listed in the listview gadget, select the program name, and then select
"Icon Window" from the "Edit" pulldown menu.
@{b}@{u}Creating Groups@{ub}@{uu}
Set the checkmarks in the listview to your desired settings.
Choose "Create Group" from the "Edit" menu.
Type the name that you want to call the group and press enter.
You now have a new group.
@{i}You MUST save the settings, or the new group will be forgotten.@{ui}
@{i}A requester will be appear to allow you to save any group modifications on quiting.@{ui}
@{b}@{u}Selecting a Group@{ub}@{uu}
Choose "Group" from the "Select" menu.
Select the name of the group you want to use from the list and select
"Ok". (Double clicking works too)
@{b}@{u}Other Gadgets@{ub}@{uu}
Select "Save" to save the settings.
Select "Cancel" to exit the program without making any changes.
Select the "Restore" menu to restore the setting to what they were
when WBStartup+Prefs was run.
@endnode
@node "EXECUTEORDER" "Changing execution order"
@{b}How to change the order in which the startup programs are run.@{ub}
Use the @{"
WBStartup+Prefs
" link "WBSTARTUPPREFS" 0} program.
You may add the tooltype @{"
STARTPRI
" link "STARTPRI" 0} to any of the startup programs icons.
@endnode
@node "TOOLTYPES" "Tooltypes"
@{b}Tooltypes@{ub}
Choose the program:
@{"
WBStartup+
" link "WBSTARTUP" 0}
@{"
WBStartup+Prefs
" link "WBSTARTUPPREFS" 0}
@{"
Startup
Programs
" link "STARTUPTOOLTYPES" 0}
@endnode
@node "ENABLEDPATH" "Tooltype:
ENABLEDPATH"
@{b}ENABLEDPATH=@{ub}
Set ENABLEDPATH to the directory where the programs are that you want
to run at startup (boot time).
Default:
ENABLEDPATH=SYS:WBStartup/WBStartup (Enabled)
@endnode
@node "DISABLEDPATH" "Tooltype: DISABLEDPATH"
@{b}DISABLEDPATH=@{ub}
Set DISABLEDPATH to the directory where programs that should not be
run at startup are. This is like a storage directory.
Default:
DISABLEDPATH=SYS:WBStartup/WBStartup (Disabled)
@endnode
@node "PROGRESSWINDOW" "Tooltype: PROGRESSWINDOW
@{b}PROGRESSWINDOW@{ub}
This allows you to disable the progress window.
This tooltype has NO values, it either exists or it doesn't.
To disable the progress window, simple place parenthesis
around the tooltype name.
Examples:
PROGRESSWINDOW The progress window will be shown
(PROGRESSWINDOW) No progress window will be shown
Default:
PROGRESSWINDOW
@endnode
@node "BACKGROUNDPIC" "Tooltype:
BACKGROUNDPIC"
@{b}BACKGROUNDPIC=@{ub}
@{i}For OS3.x only.@{ui}
This allows you to choose what the progress window's background
picture. The datatypes.library is used, so you may use any
picture format for which you have the corresponding datatype,
ie. jpeg, gif, ilbm, tiff, targa, pict, pcx, bmp, etc. Although
since some datatypes are slow, I recommend using ilbm pictures.
Values:
NONE No picture is used.
SCREEN The default Workbench Screen picture is used.
WINDOWS The default Workbench Window/Drawer picture is used.
WORKBENCH The default Workbench Root (non-backdrop) picture is used.
@{i}filename@{ui} Type the pathname and filename of any picture you want.
Default:
BACKGROUNDPIC=WINDOWS
Example:
BACKGROUNDPIC=sys:pictures/favoritepic.iff
@endnode
@node "PREFSPATH" "Tooltype: PREFSPATH"
@{b}PREFSPATH=@{ub}
Set PREFSPATH to the path of the preferences program.
Default:
PREFSPATH=SYS:Prefs/WBStartup+Prefs
@endnode
@node "ALPHABETIZE" "Tooltype: ALPHABETIZE"
@{b}ALPHABETIZE@{ub}
If this tooltype exists, the list of programs will be in alphabetical
order, otherwise it will be in order by priority.
Examples:
ALPHABETIZE The list will be alphabetized from A to Z.
(ALPHABETIZE) The list will be ordered by priority.
@endnode
@node "STARTUPTOOLTYPES" "Startup Programs"
@{b}@{u}Tooltypes that WBStartup+ looks at@{ub}@{uu}
@{"
STARTPRI
" link "STARTPRI" 0}
@{"
" link "WAIT" 0}
@{"
TOOLPRI
" link "TOOLPRI" 0}
@endnode
@node "STARTPRI" "Tooltype: STARTPRI"
@{b}STARTPRI=@{ub}
This is the startup priority for each program. The program with the highest
priority will be loaded and run first.
The values can be 127 to -128, where 127 has the highest priority and would
be run first.
Programs without this tooltype are considered to have a priority of 0.
Example:
STARTPRI=100
For instance, I gave MagicCopper : STARTPRI=127 since I want that
ugly plain looking screen to go away as soon as possible.
And I gave ToolManager : STARTPRI=120 so it will load second, and I will
have access to all my hotkeys quicker.
@endnode
@node "WAIT" "Tooltype: WAIT"
@{b}WAIT=@{ub}
If a program's icon has this tooltype, there will a delay of xxx seconds
after that program is run (before then next program in loaded and run).
Example:
WAIT=3
So after thae program with this tooltype is run, there will be a
3 seconds delay before the next program is loaded and run.
@endnode
@node "TOOLPRI" "Tooltype: TOOLPRI"
@{b}TOOLPRI=@{ub}
This is the priority that the program is to have after it is loaded.
Programs with high priorities get use of the CPU more than programs
with low priorites.
A priority of 0 is default.
The maximum priority is 127.
The minimum priority is -128.
Most priorities are in the range -5 to 5.
Usually this should just be 0, or not set.
@endnode
@node "CATALOGS" "Catalogs"
@{b}Catalogs@{ub}
The following is a list of catalogs
and their authors.
@{u}Language@{uu} @{u}Author@{uu}
Deutsch Arno Eigenwillig with assistance from Hubert Feyrer
Fran
ais Eric Sauvageau
Italiano Giacomo Magnini
Norsk Stian S. Olsen
Svenska dast@sth.frontec.se
The current .ct file is included in the locale
directory. If you would like to see WBStartup+
in your language, please add your translations to
that file and email it to me :)
@endnode
@node Index "Index"
Documents
@{"Author & Tech" link "AUTHOR"}
@{"Bugs" link "BUGS"}
@{"Catalogs" link "CATALOGS"}
@{"Changing execution order" link "EXECUTEORDER"}
@{"Contributions" link "CONTRIBUTIONS"}
@{"History" link "HISTORY"}
@{"How to use WBStartup+" link "WBSTARTUP"}
@{"How to use WBStartup+Prefs" link "WBSTARTUPPREFS"}
@{"Installation Instructions" link "INSTALL"}
@{"Startup Programs" link "STARTUPTOOLTYPES"}
@{"Synopsis" link "SYNOPSIS"}
@{"Tooltype:
ENABLEDPATH" link "ENABLEDPATH"}
@{"Tooltype:
BACKGROUNDPIC" link "BACKGROUNDPIC"}
@{"Tooltype: ALPHABETIZE" link "ALPHABETIZE"}
@{"Tooltype: DISABLEDPATH" link "DISABLEDPATH"}
@{"Tooltype: PREFSPATH" link "PREFSPATH"}
@{"Tooltype: PROGRESSWINDOW
" link "PROGRESSWINDOW"}
@{"Tooltype: STARTPRI" link "STARTPRI"}
@{"Tooltype: TOOLPRI" link "TOOLPRI"}
@{"Tooltype: WAIT" link "WAIT"}
@{"Tooltypes" link "TOOLTYPES"}
@{"WBStart-Handler Info" link "WBSTARTHANDLER"}
@{"WBStartup+" link "Main"}
@{"Where to get Updates" link "AVAILABILITY"}
Buttons
ALPHABETIZE
" link "ALPHABETIZE" 0}
Author
" link "AUTHOR" 0}
BACKGROUNDPIC
" link "BACKGROUNDPIC" 0}
" link "BUGS" 0}
Catalogs
" link "CATALOGS" 0}
Changing
execution
order
" link "EXECUTEORDER" 0}
DISABLEDPATH
" link "DISABLEDPATH" 0}
ENABLEDPATH
" link "ENABLEDPATH" 0}
Features
" link "SYNOPSIS" 0}
History
" link "HISTORY" 0}
Installing/Updating
" link "INSTALL" 0}
L:WBStart-Handler
" link "WBSTARTHANDLER" 0}
PostcardWare
" link "CONTRIBUTIONS" 0}
PREFSPATH
" link "PREFSPATH" 0}
PROGRESSWINDOW
" link "PROGRESSWINDOW" 0}
postcard
" link "CONTRIBUTIONS" 0}
STARTPRI
" link "STARTPRI" 0}
Startup
Programs
" link "STARTUPTOOLTYPES" 0}
TOOLPRI
" link "TOOLPRI" 0}
" link "WAIT" 0}
WBStartup+
" link "WBSTARTUP" 0}
WBStartup+
" link "WBSTARTUP" 0}
WBStartup+
" link "WBSTARTUP" 0}
WBStartup+Prefs
" link "WBSTARTUPPREFS" 0}
WBStartup+Prefs
" link "WBSTARTUPPREFS" 0}
WBStartup+Prefs
" link "WBSTARTUPPREFS" 0}
Where
Updates
" link "AVAILABILITY" 0}
@endnode